collection

10. Querying calendar resources

Querying provides a mechanism by which information can be obtained from the service through possibly complex queries. A list of iCalendar properties can be specified to limit the amount of information returned to the client. A query takes the parts

  • Limitations on the data returned

  • Selection of the data

  • Optional timezone id for floating time calculations.

The current specification uses CalDAV multiget and calendar-query XML bodies as specified in IETF RFC 4791 with certain limitations and differences.

  1. The POST method is used for all requests, the action being identified by the outer element.

  2. While CalDAV servers generally only support IETF RFC 5545 and assume that as the default, the delivery format for CalWS will, by default, be Internet-Draft draft-daboo-et-al-icalendar-in-xml-11.

  3. The CalDAV query allows the specification of a number of DAV properties. Specification of these properties, with the exception of DAV:getetag, is considered an error in CalWS.

  4. The CalDAV:propnames element is invalid

With those differences, the CalDAV specification is the normative reference for this operation.